home *** CD-ROM | disk | FTP | other *** search
/ ftp.cs.arizona.edu / ftp.cs.arizona.edu.tar / ftp.cs.arizona.edu / icon / newsgrp / group96a.txt / 000039_icon-group-sender _Wed Feb 7 11:47:33 1996.msg < prev    next >
Internet Message Format  |  1996-09-05  |  1KB
  1. Received: by cheltenham.cs.arizona.edu; Wed, 7 Feb 1996 12:29:46 MST
  2. Date: Wed, 7 Feb 1996 11:47:33 -0600
  3. Message-Id: <199602071747.LAA10210@ns1.computek.net>
  4. Mime-Version: 1.0
  5. Content-Type: text/plain
  6. Content-Transfer-Encoding: 7bit
  7. From: gep2@computek.net
  8. Subject: On-line IPL documentation
  9. To: icon-group@cs.arizona.edu
  10. X-Mailer: SPRY Mail Version: 04.00.06.17
  11. Errors-To: icon-group-errors@cs.arizona.edu
  12. Status: O
  13.  
  14. >An example of this is a collection of IPL Web pages rooted at
  15. http://www.cs.utsa.edu/research/icon/ipl/HTML/
  16.  
  17. >Suggestions on improving this documentation are welcome.  
  18.  
  19. I've taken a look at the Web page.  Here are my preliminary comments:
  20.  
  21. 1)  The directory listing would be more usable if it were posted as an unordered 
  22. list, so that entries would be on separate lines (note that not everybody 
  23. chooses to use Netscape).
  24.  
  25. 2)  I think it would also be helpful to give some indication as to how major 
  26. and/or complete the application is.  A trivial fifteen-line program that "counts 
  27. words and lines of a source file" is obviously in a very different class than a 
  28. much more ambitious application of several hundred (or thousand) lines.  The 
  29. kind of information that could be collected automatically and which might give 
  30. at least a hint about program completeness would be lines or bytes of source, 
  31. and perhaps how many different data files the program uses.
  32.  
  33. Gordon Peterson
  34. http://www.computek.net/public/gep2/
  35.  
  36.